package com.aaa.forum.services;

import com.aaa.forum.model.Article;
import org.apache.ibatis.annotations.Param;
import org.springframework.transaction.annotation.Transactional;

import java.util.List;

public interface IArticleService {

    /**
     * 新增帖子
     * 这个方法中, 需要执行三条SQL语句
     * 1. 插入一篇帖子
     * 2. 更新板块帖子数量
     * 3. 更新用户帖子数量
     * 需要使用事务管理
     * @param article   帖子信息
     */
    void create(Article article);

    /**
     * 查询所有的帖子
     * @return
     */
    List<Article> selectAll();

    /**
     * 根据板块id, 查询板块下所有的帖子
     * @param boardId   板块id
     * @return
     */
    List<Article> selectAllByBoardId(Long boardId);


    /**
     * 根据帖子id, 查询帖子详情，并更新数据库
     * 1. 更新帖子访问数量
     * 2. 更新历史记录表
     * @param UserId        用户id
     * @param ArticleId     帖子id
     * @return      帖子详情(帖子信息,作者信息,板块信息)
     */
    @Transactional
    Article selectDetailById(Long UserId, Long ArticleId);

    /**
     * 编辑帖子
     * @param id        帖子id
     * @param title     标题
     * @param content   正文
     * @param boardId   板块id
     */
    @Transactional
    void modify(Long id, String title, String content, Long boardId);


    /**
     * 通过帖子id, 查询帖子基本信息
     */
    Article selectById(Long id);

    /**
     * 根据帖子id, 删除帖子
     * 1. 更新帖子表
     * 2. 更新用户帖子数量
     * 3. 更新板块帖子数量
     * @param id    帖子id
     */
    @Transactional  // 当前方法内的操作, 会使用事务进行管理
    void deleteById(Long id);

    /**
     * 帖子回复数量 +1
     * @param id    帖子id
     */
    void addOneReplyCountById(Long id);

    /**
     * 帖子点赞数量 +1
     * @param id    帖子id
     */
    void addOneLikeCountById(Long id);

    /**
     * 帖子点赞数量 -1
     * @param id    帖子id
     */
    void subOneLikeCountById(Long id);

    /**
     * 帖子删除数量 +1
     * @param id    帖子id
     */
    void addOneMarkCountById(Long id);

    /**
     * 帖子收藏数量 -1
     * @param id    帖子id
     */
    void subOneMarkCountById(Long id);

    /**
     * 根据用户id，查询该用户所有的帖子
     * @param userId    用户id
     * @return          帖子列表
     */
    List<Article> selectAllByUserId(Long userId);

    /**
     * 根据用户id，查询该用户关注的人的帖子
     * @param userId    用户id
     * @return          帖子列表
     */
    List<Article> selectBySubscribe(Long userId);

    /**
     * 根据用户id，获取该用户默认收藏夹的帖子列表
     * @param userId    用户id
     * @return          帖子列表
     */
    List<Article> selectByDefaultCollection(Long userId);

    /**
     * 根据收藏夹id，获取该收藏夹下的帖子列表
     * @param collectionId  用户id
     * @return              帖子列表
     */
    List<Article> selectByCollectionId(Long collectionId);

    /**
     * 根据帖子标题，模糊查询帖子列表
     * @param title     帖子标题
     */
    List<Article> selectByTitle(String title);

    /**
     * 查询所有审核状态下的帖子(state: 1, 2)
     */
    List<Article> selectAllExamine();

    /**
     * 根据用户id，查询该用户所有审核状态下的帖子(state: 1, 2)
     * @param userId    用户id
     */
    List<Article> selectAllExamineByUserId(Long userId);

    /**
     * 根据帖子id，查询审核中的帖子详情
     * @param id    帖子id
     */
    Article selectAllState(Long id);

    /**
     * 根据帖子id，修改该帖子的状态
     * @param id        帖子id
     * @param state     帖子状态
     */
    @Transactional
    void modifyState(Long id, Byte state);
}
